package com.huffman.smart_picture.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.huffman.smart_picture.common.UserSession;
import com.huffman.smart_picture.domain.entity.Space;
import com.huffman.smart_picture.domain.request.space.SpaceCreateRequest;
import com.huffman.smart_picture.domain.request.space.SpaceInviteUserRequest;
import com.huffman.smart_picture.domain.vo.manage.DashboardSpaceRatioVo;
import com.huffman.smart_picture.domain.vo.space.AbbreviationSpaceVo;
import com.huffman.smart_picture.domain.vo.space.SpaceUserVo;
import com.huffman.smart_picture.domain.vo.space.SpaceVo;

import javax.servlet.http.HttpServletRequest;
import java.util.List;

/**
 * @author DengLin
 * @description 针对表【space(空间)】的数据库操作Service
 * @createDate 2025-02-06 20:21:39
 */
public interface SpaceService extends IService<Space> {

    /**
     * 创建空间
     *
     * @param spaceCreateRequest
     * @param userSession
     * @return
     */
    Long createSpace(SpaceCreateRequest spaceCreateRequest, HttpServletRequest userSession);

    /**
     * 验证空间是否合法
     *
     * @param space
     * @param create
     */
    void validSpace(Space space, boolean create);

    /**
     * 根据space级别自动填充空间额度
     *
     * @param space
     */
    void fillSpaceBySpaceLevel(Space space);

    /**
     * 根据用户id 获取其所有的空间信息
     * @param userId
     * @return
     */
    List<AbbreviationSpaceVo> getAbbreviationSpaceVo(Long userId);

    /**
     * 邀请用户加入空间
     *
     * @param spaceInviteUserRequest
     * @param userSession
     * @return
     */
    boolean inviteUser(SpaceInviteUserRequest spaceInviteUserRequest, UserSession userSession);

    /**
     * 获取当前用户空间权限
     * @param id
     * @param userSession
     * @return
     */
    SpaceUserVo getSpaceUserAuth(Long id, UserSession userSession);

    /**
     * 获取空间部分信息
     * @param id
     * @return
     */
    SpaceVo searchSpaceVo(Long id);

    /**
     * 获取空间所有用户部分信息
     * @param id
     * @return
     */
    List<SpaceUserVo> getSpaceUsers(Long id);

    /**
     * 获取空间不同类型占比
     * @return
     */
    DashboardSpaceRatioVo getSpaceLevelRatio();
}
